Q3ViewerEvent
You can use theQ3ViewerEvent
function to give the 3D Viewer an opportunity to handle events involving a viewer object.
Boolean Q3ViewerEvent ( TQ3ViewerObject theViewer, EventRecord *evt);
theViewer
- A viewer object.
evt
- An event record.
DESCRIPTION
TheQ3ViewerEvent
function returns, as its function result, a Boolean value that indicates whether the event specified by theevt
parameter relates to the viewer object specified by thetheViewer
parameter and was successfully handled (TRUE
) or whether that event either does not relate to that viewer object or could not be handled by the 3D Viewer (FALSE
). Theevt
parameter is a pointer to an event record, which you usually obtain by calling the Event Manager functionWaitNextEvent
.
Q3ViewerEvent
can handle most of the events relating to a viewer object. For example, it handles all user events relating to the controller strip displayed with a viewer object. For information on how to handle editing commands in a viewer pane, see "Handling Edit Commands," beginning on page 2-31.SPECIAL CONSIDERATIONS
You should callQ3ViewerEvent
in your main event loop to give the 3D Viewer an opportunity to handle events in a window that relate to a viewer object.